/**
 * Copyright 2018 asiainfo Inc.
 **/
package com.myz.service.feign.feign;

import com.myz.service.feign.config.FeignConfig;
import com.myz.service.feign.feign.impl.ScheduleServiceHystrix;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.*;

/**
 * 通过@FeignClient（“服务名”），来指定调用哪个服务 spring.application.name
 * name：指定FeignClient的名称，如果项目使用了Ribbon，name属性会作为微服务的名称，用于服务发现
 * url: url一般用于调试，可以手动指定@FeignClient调用的地址
 * decode404:当发生http 404错误时，如果该字段位true，会调用decoder进行解码，否则抛出FeignException
 * configuration: Feign配置类，可以自定义Feign的Encoder、Decoder、LogLevel、Contract
 * fallback: 定义容错的处理类，当调用远程接口失败或超时时，会调用对应接口的容错逻辑，fallback指定的类必须实现@FeignClient标记的接口
 * fallbackFactory: 工厂类，用于生成fallback类示例，通过这个属性我们可以实现每个接口通用的容错逻辑，减少重复的代码
 * path: 定义当前FeignClient的统一前缀
 *
 * @author maoyz on 2018/9/7
 * @version: v1.0
 */
@FeignClient(value = "SERVICE-MEMBER",
        fallback = ScheduleServiceHystrix.class,
        fallbackFactory = ScheduleServiceFallbackFactory.class,
        configuration = {FeignConfig.class},
        path = "/member")
public interface ScheduleService {

    /**
     * 定义接口url
     */
    @RequestMapping(value = "/index", method = RequestMethod.GET)
    String index();

    /**
     * 定义接口url
     */
    @RequestMapping(value = "/get/{id}", method = RequestMethod.GET)
    String get(@PathVariable(value = "id") Integer id);

    /**
     * 携带header的feign请求
     *
     * @param secret   　请求头, Authorization
     * @param username 请求参数
     * @return
     */
    @RequestMapping(value = "/header", method = RequestMethod.POST)
    String header(@RequestHeader(value = "Authorization") String secret, @RequestParam(value = "username") String username);

    /**
     * 提供方抛出异常时，处理
     *
     * @param username abc
     * @return
     */
    @RequestMapping(value = "/error0", method = RequestMethod.GET)
    String error(@RequestParam(value = "username") String username);

    /**
     * 调用的提供方url不存在时
     *
     * @return
     */
    @RequestMapping(value = "/url404", method = RequestMethod.GET)
    String url404();

}
